home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Leser 15 / Amiga Plus Leser CD 15.iso / Tools / Development / mmu / Mu680x0Libs / Fixes / Fixes.ReadMe next >
Text File  |  2002-03-12  |  12KB  |  363 lines
  1. This directory contains various fixes for CBM programs and third-party
  2. products, either recommended of the MuTools or for general system house-
  3. keeping.
  4. _____________________________________________________________________________
  5.  
  6. spatch
  7.  
  8.  
  9. This is a tool program to apply patches to system components. Details about
  10. its use are presented below.
  11.  
  12. _____________________________________________________________________________
  13.  
  14. mathieeedoubbas.pch
  15.  
  16. This is a fix for the mathieeedoubbas.library V38. The patch fixes the 
  17. MathIEEE comparision that is broken in the library, negative numbers are
  18. sometimes ordered in the wrong way. 
  19.  
  20. This is no longer needed for the V45, Os 3.9, version of the library.
  21.  
  22.  
  23. How to apply the patch:
  24.  
  25. Open a shell, then change the current directory to this directory by
  26.  
  27. CD <MMULib>/Fixes
  28.  
  29. where <MMULib> is the directory where you unpacked the archive to. Then make 
  30. a copy of the original version of the mathieeedoubbas.library, and keep it
  31. in a safe place. For example:
  32.  
  33. copy LIBS:mathieeedoubbas.library to SYS:Updates
  34.  
  35. Then enter the command
  36.  
  37. spatch -oram:mathieeedoubbas.library -pmathieeedoubbas.pch libs:mathieeedoubbas.library
  38.  
  39. This will build an updated version of the mathieeedoubbas.library in ram: 
  40. Just copy it back to LIBS: by
  41.  
  42. copy ram:mathieeedoubbas.library to LIBS:
  43.  
  44. _____________________________________________________________________________
  45.  
  46. SetPatch.pch
  47.  
  48. An experimental patch for SetPatch 43.6. If applied, SetPatch will try to
  49. open the 680x0.library instead of the 68040.library, regardless of the
  50. processor found. It's then the matter of the 680x0.library to detect the
  51. processor in use, and to load the appropriate processor driver library, might
  52. it be the 68040.library, the 68060.library or the 68030.library. To run the
  53. patched version of SetPatch, you *MUST* install the 680x0.library in LIBS:
  54.  
  55.  
  56. How to apply the patch:
  57.  
  58. Open a shell, then change the current directory to this directory by
  59.  
  60. CD <MMULib>/Fixes
  61.  
  62. where <MMULib> is the directory where you unpacked the archive to. Then make 
  63. a copy of the original version of SetPatch, and keep it in a safe place. 
  64.  
  65. For example:
  66.  
  67. copy C:SetPatch to SYS:Updates
  68.  
  69. To apply the patch, enter
  70.  
  71. spatch -oram:SetPatch -pSetPatch.pch C:SetPatch
  72.  
  73. The updated edition of SetPatch will appear in RAM: Just copy it back to C:.
  74.  
  75. copy ram:SetPatch to C:
  76.  
  77. Don't forget to install the 680x0.library by:
  78.  
  79. copy <MMULib>/680x0.library to LIBS:
  80.  
  81.  
  82.  
  83. This patch comes also in additional variations:
  84.  
  85. SetPatch_44.pch
  86.  
  87. is an update for the SetPatch edition that came with the Os 3.5 package. It
  88. is applied in the same way except that "SetPatch.pch" has to be replaced
  89. by "SetPatch_44.pch" in the instructions above.
  90.  
  91. SetPatch_44_6.pch
  92.  
  93. is an upgrade for the 44.6 edition of SetPatch that was made available by
  94. the "BoingBag".
  95.  
  96.  
  97. SetPatch_44_16.pch
  98.  
  99. is a similar update for the 44.16 edition that came with BoingBag 2.
  100.  
  101.  
  102. SetPatch_44_17.pch
  103.  
  104. a similar patch for the 44.17 edition of SetPatch that comes with the
  105. Os 3.9 BB1.
  106. _____________________________________________________________________________
  107.  
  108. narrator.device.pch
  109.  
  110. The narrator device stack is setup a bit too small, which might cause
  111. warnings if MuGuardianAngel is used. This patch increases the stack size
  112. of the narrator.device.
  113.  
  114.  
  115. How to apply the patch:
  116.  
  117. Open a shell, then change the current directory to this directory by
  118.  
  119. CD <MMULib>/Fixes
  120.  
  121. where <MMULib> is the directory where you unpacked the archive to. Then make 
  122. a copy of the original version of the narrator.device, and keep it in a safe 
  123. place. For example:
  124.  
  125. copy DEVS:narrator.device to SYS:Updates
  126.  
  127. To apply the patch, enter
  128.  
  129. spatch -oram:narrator.device -pnarrator.device.pch DEVS:narrator.device
  130.  
  131. The updated edition of SetPatch will appear in RAM: Just copy it back to DEVS:.
  132.  
  133. copy ram:narrator.device to DEVS:
  134.  
  135. _____________________________________________________________________________
  136.  
  137. FixCybAccess
  138.  
  139. This fixes a flaw of the cybscsi.device and the z3scsi.device, which 
  140. access a non-allocated chip-RAM location periodically on SCSI I/O. This 
  141. program should be "run" in front of MuGuardianAngel to prevent warnings 
  142. about this bogus access, i.e. a
  143.  
  144. run <>NIL: FixCybAccess
  145.  
  146. will do it.
  147.  
  148.  
  149. More details are in the FixCybAccess.readme.
  150. _____________________________________________________________________________
  151.  
  152. FixP5Scsi
  153.  
  154. A fix similar to FixCybAccess that works by a different matter, still
  155. in experimental state. If you own a P5 scsi device that can be fixed
  156. by FixCybAccess, but not by FixP5Scsi, please let me know.
  157. The advantage of this program is that it does not cause any chip memory
  158. fragmentation, but it replaces the faulty instructions by hand.
  159.  
  160. This program must then be started in the startup-sequence by
  161.  
  162. FixP5Scsi
  163.  
  164. _____________________________________________________________________________
  165.  
  166. PatchRAM
  167.  
  168. A fix for two features of the RAM disk. First of all, it is also too low
  169. on stack and will generate warnings if MuGuardianAngel is active, for 
  170. good reason. Second, the RAM disk shows always up as "100% full", which I
  171. regard as pretty annoying. To install this fix, run it *BEFORE* accessing
  172. the RAM disk for the first time. A good place for this program would be
  173. directly after SetPatch.
  174.  
  175. This patch is longer available for the RAM disk that comes with Os 3.9.
  176.  
  177. More details are in the PatchRAM.readme.
  178. _____________________________________________________________________________
  179.  
  180. ConsoleFix
  181.  
  182. This repairs a a bug in the console.device supervisor task which appears on
  183. window resizing. Due to a programming fault, the device doesn't go thru all
  184. its windows correctly if one of its client windows is resized. Luckely, this
  185. doesn't seem to be fatal as long as the console.device gets enough stack 
  186. space.
  187.  
  188. This patch is no longer requires for Os 3.9 since it comes with a new
  189. console.device anyhow.
  190.  
  191. Details about how this fix works are in the ConsoleFix.readme
  192. _____________________________________________________________________________
  193.  
  194. IPrefs.pch
  195.  
  196. Increases the stack size of the 40.7 IPrefs to 8K making it more stable when
  197. using datatypes as background pictures. This will effectively fix the 
  198. "Nearly out of stack" messages of IPrefs, too.
  199.  
  200. This patch is no longer required for Os 3.5 and above.
  201.  
  202. _____________________________________________________________________________
  203.  
  204. mfmdev.pch
  205.  
  206. Increases the stack size of the Os 3.1 release of the mfm.device used 
  207. by CrossDos, avoiding the "Nearly out of stack" messages MuGuardianAngel
  208. would show. This fix was provided by Gene Heskett, thanks Gene!
  209.  
  210. -----------------------------------------------------------------------------
  211.  
  212. RamLibFix
  213.  
  214. Fixes two bugs in the ramlib process. First of all, ramlib is too low on
  215. stack which might cause certain problems. The mmu.library works around
  216. this problem anyhow by swapping in its own stack, but this might be an
  217. issue for other libraries as well. Second, ramlib uses SIGF_SINGLE as
  218. message bit for its command message port, but the same bit has been used
  219. for semaphore signalling. Hence, some race conditions could result if
  220. semaphores are used in the library setup code. The bug has been reported
  221. by Eddy Carroll (SnoopDos). Thanks, Eddy!
  222.  
  223. This program *ABSOLUTELY MUST* be copied into C:, and its name *MUST NOT
  224. BE CHANGED*, due to the way it works.
  225.  
  226. This patch is longer required for Os 3.9.
  227.  
  228. -----------------------------------------------------------------------------
  229.  
  230. ConFix
  231.  
  232. And just another console related fix. This one increases the stack size of
  233. the native CON: and RAW: handlers. It is not required if you use a third
  234. party console replacement, e.g. ViNCEd.
  235.  
  236. No longer required for Os 3.9 as SetPatch implies a similar patch.
  237.  
  238. -----------------------------------------------------------------------------
  239.  
  240. FixLongMult
  241.  
  242. Fixes a bug in UMult64 and SMult64 for the 68000, 68010 and 68060.
  243. Does nothing for 68020, 68030 and 68040. In fact, it "corrects"
  244. the 68000, 010, 060 versions to use the same "wrong" syntax than the
  245. 68020,030,040 versions. In fact, this "wrong" syntax is now the 
  246. official syntax.
  247.  
  248. *Without this fix, the DEV-Handler and other programs will not run
  249. correctly on the 68000, 68010 and possibly the 68060.*
  250.  
  251. This fix is no longer required for Os 3.9.
  252.  
  253. ------------------------------------------------------------------------------
  254.  
  255. BVisionPPC_28.pch
  256.  
  257. This is a fix for the V28 BVisionPPC CyberGraphics 3.x driver which depends on 
  258. some undocumented internals of the P5 68040 and 68060 libraries. To apply the 
  259. patch, CD into this directory and enter the following commands:
  260.  
  261. copy DEVS:Monitors/BVisionPPC to ThisIsASafePlace:BVisionPPC
  262.                  ^^^^^^^^^^^^^^^^^
  263.                 Changed accordingly to your
  264.                 private backup device or directory.
  265.  
  266. Then apply the patch:
  267.  
  268. spatch -oram:BVisionPPC -pBVisionPPC_28.pch DEVS:Monitors/BVisionPPC
  269.  
  270. The updated edition of the driver will appear in RAM: Just copy it back 
  271. to DEVS:Monitors...
  272.  
  273. copy ram:BVisionPPC to DEVS:Monitors
  274.  
  275.  
  276. This updated driver requires the new (>= 40.3) release of P5Init. Make sure
  277. you install the updated version of P5Init as well.
  278.  
  279. ------------------------------------------------------------------------------
  280.  
  281. BVisionPPC_42r7.pch
  282.  
  283. This is a fix for the 42.7 BVisionPPC CyberGraphics 4.x driver which depends on 
  284. some undocumented internals of the P5 68040 and 68060 libraries. To apply the 
  285. patch, CD into this directory and enter the following commands:
  286.  
  287. copy DEVS:Monitors/BVisionPPC to ThisIsASafePlace:BVisionPPC
  288.                  ^^^^^^^^^^^^^^^^^
  289.                 Changed accordingly to your
  290.                 private backup device or directory.
  291.  
  292. Then apply the patch:
  293.  
  294. spatch -oram:BVisionPPC -pBVisionPPC_42r7.pch DEVS:Monitors/BVisionPPC
  295.  
  296. The updated edition of the driver will appear in RAM: Just copy it back 
  297. to DEVS:Monitors...
  298.  
  299. copy ram:BVisionPPC to DEVS:Monitors
  300.  
  301.  
  302. This updated driver requires the new (>= 40.3) release of P5Init. Make sure
  303. you install the updated version of P5Init as well.
  304.  
  305. ------------------------------------------------------------------------------
  306.  
  307. P5Integrate
  308.  
  309. In case you do not want to patch the BVision driver, or the patch cannot be
  310. applied, you could alternatively copy P5Integrate to C: and run it in the
  311. startup sequence:
  312.  
  313. copy P5Integrate to C:
  314.  
  315. Then edit the Startup-sequence with an editor of your choice:
  316.  
  317. ed S:Startup-Sequence
  318.  
  319. Locate the SetPatch command in the startup sequence, move the cursor below 
  320. that line and press <RETURN> to open a new line. Within the new line, enter
  321.  
  322. P5Integrate
  323.  
  324. Then save the changes. Make sure that you really installed the latest P5Init
  325. or this command won't work.
  326.  
  327.  
  328. P5Integrate is IMHO the least pleasent way to make some obscure P5 wierdos
  329. available the the BVision driver. It has also to modify the library version
  330. number such that the revision information is no longer accurate.
  331.  
  332. ------------------------------------------------------------------------------
  333.  
  334. SetFastAvec.pch
  335.  
  336. Patches the P5 "SetFastAvec" program, release 1.4 to use the "p5emu.library"
  337. and hence to co-operate with the "P5Init" program of the MMU-Configuration.
  338.  
  339. To apply the patch, enter
  340.  
  341. spatch -oram:SetFastAVec -pSetFastAvec.pch C:SetFastAvec
  342.  
  343. The updated edition of SetFastAvec will appear in RAM: Just copy it back to C:.
  344.  
  345. Note: This requires to run "P5Init" in the MMU-Configuration file.
  346.  
  347. ------------------------------------------------------------------------------
  348.  
  349. setmemmode.pch
  350.  
  351. Patches the P5 "setmemmode" program, release 1.5 to use the "p5emu.library"
  352. and hence to co-operate with the "P5Init" program of the MMU-Configuration.
  353.  
  354. To apply the patch, enter
  355.  
  356. spatch -oram:setmemmode -psetmemmode.pch C:setmemmode
  357.  
  358. The updated edition of setmemmode will appear in RAM: Just copy it back to C:.
  359.  
  360. Note: This requires to run "P5Init" in the MMU-Configuration file.
  361.  
  362. ------------------------------------------------------------------------------
  363.